home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / GRAPHICS / EARTHS20.ZIP / READ.ME < prev    next >
Text File  |  1993-11-09  |  5KB  |  134 lines
  1.                        EarthSun 2.0 - November 9th, 1993
  2.                        ---------------------------------
  3.  
  4. What is EarthSun?
  5. ----------------
  6. EarthSun is a MicroSoft Windows 3.x program that displays the current
  7. sunlit-side of the Earth in an icon.
  8.  
  9.  
  10. Installing EarthSun
  11. -------------------
  12. Simply use the Program Manager to create a New Program Icon in the group of
  13. your choice.  Set the "Working Directory" to be where you want the
  14. EARTHSUN.INI file stored (I recommend your Windows subdirectory).  I also
  15. recommend placing the icon in the "Startup" group so it loads every time
  16. you start Windows.
  17.  
  18. If you don't already have the file BWCC.DLL, make sure you copy it to your
  19. Windows system subdirectory and erase any other copies of it.  See the file
  20. BWCC.TXT for more information.
  21.  
  22.  
  23. Setting your Time Zone
  24. ----------------------
  25. EarthSun must know the time zone in which you live to display the icon
  26. properly.  The default is the Eastern Standard Time time zone, which is
  27. valid for cities in the United States such as New York City, Boston and Miami.
  28. If you live in another time zone, you must select it yourself.
  29.  
  30. When you first run EarthSun, the program's About box appears.  Here you'll find
  31. a list box containing all of the time zones.  Simply select the one in which
  32. you live.  There is also a check box if you want the Daylight Savings Time
  33. (Summer Time) adjustment applied or not.  Check this box if your area observes
  34. Daylight Savings Time.  Remember to check/uncheck this box twice a year when
  35. the time changes.
  36.  
  37.  
  38. Animating the EarthSun icon
  39. ---------------------------
  40. You can also select an "update interval" for the EarthSun icon.  The default
  41. is "Real-Time", which shows the current sunlit side of the Earth.  Other
  42. values are available to "animate" the icon, or to display a new icon once
  43. every update interval.  The values you may choose from are once every
  44. second, every five seconds or every ten seconds.
  45.  
  46.  
  47. Changing the icon's title
  48. -------------------------
  49. You can change the title beneath the icon to whatever you like.  More
  50. importantly, you can have the current date and/or time displayed here as well.
  51.  
  52. The About box has the default icon title set to "~1~a ~w ~m ~d~o", which means
  53. to display the current time in 12-hour format, have either "am" or "pm"
  54. displayed after the time, show the day-of-the-week in 3 letter, show the
  55. month in 3 letters, show the day-of-the-month followed by "st", "rd", etc.
  56. For example, "9:05pm Tue Nov 9th".  Note how you can add spaces between the
  57. various options to cause them to "wrap" down to the next icon title line, if
  58. desired.
  59.  
  60. If you prefer, you can change the title to be just a simple word or two, like
  61. "Earth" or "Earth's sunlit side".
  62.  
  63. All the available options are listed below:
  64.  
  65. ~1  =  12-hour format
  66. ~2  =  24-hour format
  67. ~a  =  "am" or "pm"
  68. ~A  =  "AM" or "PM"
  69. ~p  =  "a" or "p"
  70. ~P  =  "A" or "P"
  71. ~w  =  "Mon", "Tue", etc.
  72. ~W  =  "Monday", "Tuesday", etc.
  73. ~m  =  "Jan", "Feb", etc.
  74. ~M  =  "January", "February", etc.
  75. ~d  =  Day of the month (1-31)
  76. ~y  =  "93", etc. (Year without the century)
  77. ~Y  =  "1993", etc. (Year with the century)
  78. ~o  =  "st", "nd", "rd", "th", etc. (as in 1st, 2nd, 3rd, 4th, etc.)
  79.  
  80. Other icon titles that you might like are:
  81.  
  82.    "~2 ~W ~m ~d~o"            (21:05 Tuesday Nov 9th)
  83.    "~1~A"                     (9:05PM)
  84.    "Earth's Sunlit Side"      (Earth's Sunlit Side)
  85.  
  86.  
  87. Planned Enhancements
  88. --------------------
  89. I still plan on increasing the number of Earth icons from the current 16 to
  90. 32, so the user can see a new image every 45 minutes instead of every 90
  91. minutes.
  92.  
  93.  
  94. Other related programs
  95. ----------------------
  96. In the fall of 1993, look for MARSICON.ZIP, a Windows icon that shows the
  97. current view of Mars and GREDSPOT.ZIP, a Windows icon that shows the current
  98. position of Jupiter's Great Red Spot.  Both of these programs are currently
  99. being tested and are receiving the "finishing touches".
  100.  
  101.  
  102. Registering EarthSun
  103. --------------------
  104. Print out the file ORDER.FRM to get a quick order form for registering
  105. EarthSun.  When you register, you will receive the latest executable version
  106. and the full Borland C++ 3.1 source code used to make it.  The cost of the
  107. diskette and the mailing charges are all included in the US $10 registration
  108. fee (Sorry, I do not yet accept credit card orders).  If you find EarthSun
  109. useful, please upload it to other bulletin boards and/or Internet FTP sites
  110. so other people can see the sunny side of our planet!
  111.  
  112.  
  113. Author Information
  114. ------------------
  115. Any suggestions, bugs, ideas, complaints?  Please let me know what you think
  116. of this program so I can improve it!
  117.  
  118. Mail Address:
  119.  
  120.    W. Scott Thoman
  121.    41 Lee Road
  122.    Dryden, NY  13053
  123.    USA
  124.  
  125. Internet E-Mail Address:
  126.  
  127.    thoman@law.mail.cornell.edu
  128.  
  129.  
  130. -------------------------------------------------------------------------------
  131.                        Thank you for using EarthSun!
  132. -------------------------------------------------------------------------------
  133.  
  134.